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SKC3120 
ASSEMBLER LANGUAGE (KAL31) 
REFERENCE MANUAL 



ABSTRACT 

This manual describes the syntax and function of KAL31, the 
SKC3120 Assembly Language. This language is a derivative of the 
FOCAP Language developed for the SKC2000 computer. An SKC3120 
computer program written in this language is automatically 
converted to machine language by the SKC3120 Portable Assembler 
Program. The Portable Assembler was carefully designed to permit 
it to be easily transferred from one host machine to another, hence 
the term Portable. 

This document/ in conjunction with the SKC3120 Principles of 

Operation Manual (Y240A300M0801) and the SKC3120 Assembler/ Linkage 

Editor/Simulator Users Manual (Y2U0A301M0811) provides sufficient 

information for a programmer to prepare an SKC3120 computer 
program. Details on the use of the Portable Assembler with a 

particular host computer can be found in the appropriate Host 
Procedures Manual. 

Users are encouraged to make suggestions for improving the 
information content of this manual by using the form supplied on 
the last page. 
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1. INTRODUCTION 

The SKC3120 Assembler program accepts KAL31 source code and 
produces absolute or relocatable object programs which, after 
processing by the Linkage Editor program, will execute on the 
SKC3120 computer. The KAL31 Assembler is a "cross assembler 11 in 
that it executes on a general purpose computer, hereby designated 
as a "host 11 computer/ and produces code for the SKC3120, hereby 
designated as the "target 11 computer. This Assembler is an element 
of Kearfott's complement of machine-portable, modular software. 
The SKC3120 (KAL31) Assembler, in particular, has been designated 
as both host and target machine portable, since only a relatively 
few modules require modification when it is desired to change 
either the host or target computer. Host machine portability 
allows Kearfott to provide this Assembler for execution on the 
customer's host computer, without the entailment of expensive 
conversion costs. Furthermore, since approximately 85 percent of 
the modules are completely machine independent, the introduction of 
errors due to conversion from one host to another is minimal. 
Target-machine portability allows expeditious adaptation of the 
software when the target computer's configuration is altered. 
Changes in the instruction set, data word length, etc. are easily 
implemented in the Assembler since only a very few modules are 
effected for each of these changes. Additionally, target-machine 
portability provides a significant step towards the production of 
error-free codes. Since the majority of the modules are common to 
Kearfott assemblers for other target computers, errors detected in 
one application, and corrected, do not always have to be 
rediscovered in other applications. 

The SKC3120 Assembler contains several features usually available 
only on larger computers. The Assembler is capable of producing 
relocatable object code, whose absolute locations are assigned by 
the Linkage Editor Program. This rel.oca.tabf 1 i ty feature al lows the 
use of location counters: for aiding In the organization of the 
source program, for eliminating the need for the programmer to 
choose absolute addresses, and for optimizing memory allocation. 
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The user has complete control over the assembly process. This 
control is exercised via control cards and assembler options (see 
Appendix B, Assembler Controls and Options). Subroutines may be 
assembled individually or in groups. The Assembler detects 
syntactic programming errors/ illegal opcodes/ some types of 
addressing errors, and checks the source coding in general for 
conformance. On user option the Assembler will perform a load, and 
produce a memory load map onto magnetic tape and/or the printer. 
The map indicates the exact memory loading of the SKC3120. In 
addition to those features al ready implemented, Kearfott has 
developed a general purpose macro processor to be used in 
conjunction with all its assemblers. The capabilities of this 
macro processor include complete arithmetic, logical, and character 
expression handling, the nesting of macros, recursive macro 
invocation, and a conditional assembly facility. 

The Assembler output includes: 

* A printed listing containing: 

a. Program source code 

b. Line numbers 

c. Hexadecimal representation of the assembled source code 

d. Relative address of each instruction 

e. Error mnemonics 

f. Current location counter 

* An object deck if requested by the user. 

* A magnetic tape for use eventually in the simulator or to be 
converted to punched tape and loaded into the SKC3120 for 
execution. 
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2. LANGUAGE STRUCTURE 



The SKC3120 Computer Assembler Program was developed to run on an 
IBM 360/370 computer. The Portable Version of the Assembler was 
written almost exclusively in ANSI Fortran. Hence, it can be 
easily converted to run on similar host computers using a similar 
Fortran compiler. The source language processed by this Assembler 
is described in this document. Some basic language features are 
described in this section. 

The language provides a mnemonic (literally, memory-aiding) machine 
instruction operation code for each machine instruction in the 
SKC3120 airborne computer. The Assembler language also contains 
mnemonic codes for Assembler directive operations. These are used 
to provide the direction necessary for the Assembler to perform its 
wide variety of auxi 1 i lary functions. 

Assembler processing involves the translation of source statements 
into machine language, the assignment of memory words to 
instructions and data, and the development of al 1 information 
required by the Linkage Editor Program for final memory allocation. 
The output of the Assembler program is a relocatable or absolute 
object program module, a machine language translation of the input 
source program module. The Assembler generates a printed listing 
of the source statements, side by side with their machine language 
translation, relocatable or absolute addresses, and additional 
information useful to the programmer in analyzing his program, such 
as error indications. 

2.1 SOURCE LANGUAGE STATEMENT 



An SKC3120 Assembly program consists of a sequence of source 
language statements or symbolic instructions. Each statement 
consists of one to four entries, which are from left to rights a 
label entry, an operation entry, an operand entry, and a comments 
entry. These entries must be separated by one or more blanks and 
must be written in the order stated. A brief description of each 
entry follows. 

2.1.1 Label Entry 



The label entry is a symbol created by the programmer to identify a 
statement. The label symbol is used to reference the statement in 
the operand entry of other statements. A label entry is usually 
optional. Like .all symbols, the label entry may consist of up to 
eight alphanumeric (or alphameric) characters, the first of which 
must be alphabetic. 
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2.1*2 Operation Entry 



The operation entry is the mnemonic operation code specifying the 
SKC3120 machine operation, or assembler directive operation 
desired. An operation entry is mandatory (except for a full 
comment statement). Valid mnemonic operation codes for each 
machine operation are listed in an appendix. All assembler 
directive operation codes are listed in Section 5 (Table 5-1). 

2.1.3 Operand Entry 



Operand entries identify and describe data to be acted upon by the 
machine or assembler operation. The operand entry has a variety of 
formats described in Sections k and 5. Depending on the 
requirements of the operation, one or more or no operands can be 
specified. Multiple operand entries must be separated by commas, 
and they cannot include embedded blanks. 

2.1.4 Comment Entry 



Comments are descriptive items of information about the statement 
or the program that are included to clarify the program listing. 
Any printable character may be included in a comment, including 
blanks. An entire statement field can be used for a comment if an 
asterisk or period is punched in the first column. 

2.1.5 Character Set 



The standard FORTRAN character set forms the basis for the KAL31 
character set (except that any printable character may be used for 
comments). The character set for the label field is the alphabetic 
A-Z and the numbers 0-9. The character set for the operation field 
is in the alphabetic characters A-Z combined to form a legal 
Assembler mnemonic operation code. The character set of the 
operand field is the alphabetic characters A-Z, the numbers 0-9 and 
the special characters shown below: 

* . , + - blank 

For comments, any printable character is acceptable. For the IBM 
360/370 version of the Assembler, the EBCDIC character set is used. 
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2.1.6 Statement Format 



The primary input medium to the Assembler 
Source statements are punched one per card 



LABEL FIELD 



Must start in col. 1 
may be up to 8 char, 
in length; must be a 
symbol (see Section 
2.2.1) 



OPERATION FIELD 



is the punched card, 
in the following format: 

OPERAND FIELD 



May not start in col. 1 
Must be legal mnemonic 
operation code. One 
or more blanks must 
separate the label and 
the operation fields. 



Format depends on 
instr. used. One 
or more blanks 
must separate the 
operation and the 
operand fields. 



Comments may be placed on a card in 
least one blank following the 
asteriskC*) or period (.) in column 
the next field is assumed to be the 



one of two ways: after at 
operand field, or after an 
1. If column 1 is left blank, 
operation field. 



The fields are free format, with the exception that a label field 
or comment statement must start in column 1; however, standard card 
columns for starting fields are recommended for the sake of 
legibility. Figure 2-1 shows the standard Assembler coding form, 
in which the operation field starts in column 10 and the operand 
field begins in column 16. In general, blanks delimit fields and 
commas delimit subfields. The operand field varies with the type 
of the operation (see Sections k and 5). 

2.2 LANGUAGE ELEMENTS 



Before describing the various 
appropriate to discuss the 
Assembler. Principal among 
their attributes. Of course, 
expressions is the mnemonic 
other numeric value. These 
utility as constituents 
statements. 



assembler operations in detail, it is 
basic language elements of the 
these are expressions, symbols, and 

the principal use of symbols and 

representation of a memory address or 
language elements have their prime 

of the operand entry in assembly 
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2.2.1 SYMBOLS 



A symbol* is represented by a string of one to eight alphameric 
characters (A-Z, 0-9)/ the first of which must be alphabetic. A 
symbol is defined by its appearance in the label field of a 
statement. A symbol may be defined only once in an assembly, 
unless it is a set-symbol. That is, each symbol used as the label 
of a statement must be unique within that assembly. A numeric 
value is associated with each symbol. Generally, a symbol in the 
label field of an instruction is assigned the value of the current 
location counter. The only exceptions are the SETD, SETX, and EQU 
operations whose label symbol is assigned the value specified by 
the operand field. When the Assembler assigns values to symbols in 
the label field of statements defining instructions, constant data 
words, or variable data words, it chooses the address of the 
designated memory word. If the designated item occupies more than 
one memory word, the address of the first word is assigned to the 
symbol . 

Although the value of a symbol is its principal attribute, several 
other attributes are worthy of mention. A symbol value may be 
either absolute or relocatable based on the type of location 
counter under which it was allocated. The symbol is then said to 
be either absolute or relocatable, accordingly. The value of a 
relocatable symbol is its displacement, in words, from the origin 
of the location counter. A symbol value may be any integer from 
zero to 65K (i.e. 65,535). This is the maximum addressing range 
of the SKC3120 computer. 

Symbols can also be distinguished by the nature of the information 
contained in the address they are referencing. Fom example, a 
symbol value may represent the address of an instruction, a 
constant data word, a variable data word, or an address pointer. 
In the latter case, the symbol may be said to have indirect 
addressing capability. 

*Two popular alternate designations for "symbol 11 are "tag" and 
"label 11 . 
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2.2.1.1 Set-Symbols 

Symbol s normal ly assume a specific (absolute or relocatable) value 
which is retained throughout the assembly of the deck. However , 
the operations SETD and SETX can be used to define temporary 
symbols or SET symbols whose value can be changed during the 
assembly of a single deck. Once a symbol value has been specifded 
by one of the SET operations/ a subsequent definition of the same 
symbol by a SET operation is considered an assembly-time 
redefinition of the symbol value. A set-symbol may be redefined 
any number of times. However, regular permanent symbols (defined 
by an operation other than SETD or SETX) cannot be redefined via 
the two SET operations. Similarly, a set-symbol cannot be 
subsequently given a permanent value by appearing in another 
statement. By virtue of the variable nature of a set-symbol, it 
must be defined in a SET statement prior to any use of the symbol. 

2.2.1.2 External Symbols 

Symbols which are used In a deck but not defined (assigned a value) 
within the deck are assumed to be defined as entry points in 
another deck. Hence, these are referred to as external symbols. A 
table of external symbols is provided in the cross reference at the 
end of each assembly listing. If a deck is processed by the 
Linkage Editor with other decks which provide entry points for each 
of its external symbols, the Linkage Editor will automatically 
resolve these interdeck address references. If no entry point is 
found for an external symbol, the Linkage Editor will print an 
appropriate error message. 

2.2.1.3 The Asterisk Symbol 

The asterisk character (.*) is used to specify a special symbol. 
When used in the operand field of an operation, it represents the 
current value of the location counter (either absolute or 
relocatable). Consequently, the asterisk (*) need not be defined 
(assigned a value) like other symbols and, therefore, should never 
appear in the label field of a statement. By its nature, the 
asterisk assumes a different value each time it is used. In this 
respect, it is similar to a temporary symbol or set-symbol, 
although it is not expl id tly defined or redefined via the SET 
operations. 
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2. 2.1. it Symbol Reference 

A symbol is said to be defined by its appearance in the label field 
of a statement* A symbol is said to be referenced by its 
appearance in the operand field of a statement. There is, in 
general, no sequence restriction on the definition and reference of 
a permanent symbol ; both forward referencing (reference proceding 
definition) and backward referencing (definition preceding 
reference) is permitted/ except where otherwise noted (e.g. EQU 
operation). The following two examples illustrate the definition 
and use of symbols. 

Forward Reference: 

LDA SMBL1 



SMBL1 DEC 1235 

Backward Reference: 

SMBL2 LDA SMBL1 

JU SMBL2 
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2.2.1.5 Relative Addressing 

As described above, the Assembl 
referenced in another f s opera 
defines a symbol in its label fi 
complex forms of symbolic 
addressing. Once a statement 
symbol in its label field, it is 
preceding or following the s 
position relative to the named s 
relative addressing, and the ope 



er permit 
nd field 
eld. Howe 

referenc? 
has been n 

possible 
tatement 
tatement. 
rand entry 



one statement to be 
f the first statement 
ver, it also permits more 
ng including relative 
amed by the presence of a 
to refer to a statement 
named by indicating its 
This procedure is called 
would take the form: 



s + n or s - n 



where: 

s represents 
instruction 



the symbol in the label field of the named 



n is a positive decimal integer which represents the difference 
between the current values of the location counter at each 
statement. 

A more specific example would be: 

SYMBOL +6 

where the referenced memory address Is six greater than the address 
labeled SYMBOL. Another common form of relative addressing is 
i 1 lustrated below: 

loc. ctr. values 



(1000) 


JEQ 


*+2 


(1001) 


JU 


LOOP 


(1002) 


STA 


ANGLE 



The asterisk (*) symbol is used to refer to the current value of 
the location counter. Relative addressing serves to introduce the 
more general concept of using expressions to represent operand 
address references which is discussed in Section 3. 
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2.2,2 Expressions 

This section discusses the expressions used in coding operand 
entries for regular source statements. Two types of expressions, 
absolute and relocatable, are presented along with the rules for 
determining the attributes of an expression. The earlier paragraph 
on relative addressing introduced the simplest type of expression 
of the form s + n. The more general case is discussed here. 

THe smallest component of a regular expression is the element. An 
element is either a single symbol or a single decimal integer less 
than 2**16. Three types of symbols may be used specifically: 

The permanent symbol 

The temporary or set-symbol 

The asterisk, representing the current location counter 
value 

An expression consists of a single element or is formed as the sum 
or difference of two elements according to the following 
restrictions: 

The difference of two relocatable elements is a valid expression 
if and only if both elements are defined under the same location 
counter. 

The sum of two relocatable elements is always invalid. 

Since expressions, like symbols, represent memory addresses, 
they cannot have a negative value and must be less than 2**16. 

An external (or virtual) symbol cannot be combined with an 
asterisk or permanent symbol to form a vaild expression. It can 
only be combined with a decimal integer or a set-symbol. 

A numeric value is associated with each expression. 
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An expression Is called absolute If Its value Is unchanged by 
program relocation. An expression Is called relocatble If Its 
value depends upon program relocation. 

An absolute expression can be an absolute symbol or any sum or 
difference of absolute elements. The difference of two relocatble 
elements (under the same location counter) Is an absolute 
expression. Since each element would be relocated by the same 
amount, the difference value remains constant and Is not effected 
by the relocation value. Hence the expresslon f s value Is absolute. 
If each element were defined under different location counters/ 
each element would have Its own relocation value and the difference 
value of the relocated element would not be constant. 
Consequently/ this combination Is specifically prohibited. 

A relocatable expression Is one whose value changes by n If the 
program In which It appears Is relocated n words away from its 
original storage location. The simplest form of relocatable 
expression is the single symbol. 

The above combinational rules can be summarized by a listing of 
legal expression constituents/ an example of legal expression type/ 
and a classification of the resulting expression as being absolute 
or relocatable. Such a listing is presented in Table 2-1 using the 
following notation: 

n represents a positive decimal integer 

s represents a permanent symbol 

st represents a set-symbol 

(r) represents a relocatable symbol (ie. defined under a 
relocatable location counter) 

(a) represents an absolute symbol (ie. defined under an 
absolute location counter) 

Note that all relocatable symbols are assumed to be defined under 
the same location counter. Otherwise the difference would be 
illegal as described above. 

Table 2-1 contains all legal combinations of the following six 
basic elements: 

n *(r) *(a) s(r) s(a) st 

By implication/ all missing sums or dlferences of these elements 
are illegal based upon the above prohibitions and should not be 
used. 
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TABLE 2-1 LEGAL EXPRESSION TYPES 



ESS ION FORM 


TYPE 


EXAMPLE 


*(r) 


relocatable 


* 


*(a) 


absolute 


* 


s ( r ) 


relocatable 


SYMREL 


s(a) 


absolute 


SYMABS 


n 


absolute 


100 


St 


absolute 


SETSYM 


*(r)-s(r) 


absolute 


*-SYMREL 


*(r)+s(a) 


relocatable 


*+SYMABS 


*(r)-s(a) 


relocatable 


*-SYMABS 


*(a)+s(r) 


relocatable 


**SYMREL 


*(a)+s(a) 


absolute 


*+SYMABS 


*(a)-s(a) 


absolute 


*-SYMABS 


*(r)+n 


relocatable 


*+l 


* ( r ) -n 


relocatable 


*-2 


*(a)+n 


absolute 


*+3 


*(a)-n 


absolute 


*-!* 


s(r)-s(r) 


absolute 


SYMR1-SYMR2 


s(r)+s(a) 


relocatable 


SYMREL+SYMABS 


s(r)-s(a) 


relocatable 


SYMREL-SYMABS 


s(a)+s(r) 


relocatable 


SYMABS+SYMREL 


s(a)+s(a) 


absolute 


SYMA1+SYMA2 


s(a)-s(a) 


absolute 


SYMA1-SYMA2 


s(r)+n 


relocatable 


SYMREL+10 


s(r)-n 


relocatable 


SYMREL-20 


s(a)+n 


absolute 


SYMABS+100 


s(a)-n 


absolute 


SYMABS-50 


*(r)+st 


relocatable 


*+SETSYM 


*(r)-st 


relocatable 


*-SETSYM 


*(a)+st 


absolute 


*+SETSYM 


*(a)-st 


absolute 


*-SETSYM 


s(r)+st 


relocatable 


SYMREL+SETSYM 


s(r)-st 


relocatable 


SYMREL-SETSYM 


s(a)+st 


absolute 


SYMABS+SETSYM 


s(a)-st 


absolute 


SYMABS-SETSYM 


st+n 


absolute 


SETSYM* 10 


st-n 


absolute 


SETSYM~t> 


st+st 


absolute 


SETS1+SETS2 


st-st 


absolute 


SETS1-SETS2 
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3. ADDRESSING AND LOADING 



The SKC3120 computer architecture provides a variety of techniques 
for addressing and i ntra-program communication. These capabilities 
are augmented by the Assembler and Linkage Editor programs. This 
section is intended to provide the programmer with sufficient 
information about these techniques to use them effectively. 

3.1 I NTRA-DECK' ADDRESSING 



A program deck is a sequence of source program statements 
terminated by an END statement. A deck may contain several 
subroutines. The techniques available to permit one statement to 
reference another, .within a deck, are discussed here. 

3.1.1 Location Counters 



A location counter is used to assign memory addresses to program 
statements within a deck. It is assigned a starting value at the 
beginning of a block (typically the address of the first word- in 
the block) and is incremented by the length of each subsequent 
statement within a deck. Thus, a location counter always points to 
the next ava I lable address . If a statement is named by a symbol in 
its label field, the symbol value is set equal to the current value 
of the location counter with the exception of the BES Pseudo-Op 
(see 5.3.2). Similarly, if an asterisk symbol Is used In the 
operand field of a statement, it is assigned the current value of 
the location counter. An asterisk symbol in the operand field of a 
machine instruct ion statement is equivalent to placing a symbol in 
the label field and using that symbol in the operand field. The 
Assembler listing includes the location counter value for each 
statement, whether labeled or unlabeled. 

Only those statements which generate object code or allocate 
storage cause the location counter to be incremented. 

Since the length of each operation can vary, the location counter 
may be incremented by various values. For instance, some Assembler 
operations such as USE or SETD, do not cause computer memory 
allocation and therefore, the location counter is unchanged. Other 
operations such as machine instructions or single precision data 
words occupy one location and increase the location counter by one. 
Long instructions (e.g. JS) and double precision data words occupy 
two locations and increase the location counter by two. Finally, 
some Assembler operations such as the BSS generate many locations 
and the location counter value is correspondingly increased. The 
Assembler has 25 location counters numbered through 2** which can 
be established and controlled by the user. 
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The use of more than one location counter provides the user with 
the facility to write instructions in one sequence and have them 
loaded in another. This enables the user to write subroutines and 
assign various data areas in-line* The Assembler identifies the 
necessary origins at assembly time, but repositioning of 
instructions under the various location counters is a function of 
the Linkage Editor and occurs at load time. The object deck 
produced by an assembly will have the same sequence as the 
corresponding source deck. The Linkage Editor processes the 
location counters of the same type within a deck in numerical 
sequence. That is, instructions or data assembled under location 
counter are loaded first; instructions or data assembled under 
Location Counter 2k are loaded last. 

A program segment assembled under a location counter can be 
absolute or relocatable. Hence, the location counter is said to be 
correspondingly absolute or relocatable for that assembly. Since 
all relocatable addresses are assembled relative to the first 
location under the location counter, the first location has a 
relative address of zero with subsequent addresses assigned in 
ascending order as described earlier. 

Each deck has at least one location counter. If none is specified, 
location counter is assumed. It is recommended that different 
types of memory words (e.g. instruction, constant data, variable 
data, etc.) be segregated by use of location counters. In fact, 
the Linkage Editor program recognizes several distinct types of 
memory blocks during the load process. These are listed in Table 
3-1. 



TABLE 3-1. LOCATION COUNTER TYPE TABLE 



TYPE OF MEMORY WORD 

Instructions 
Instructions 
Constant Data 
Constant Data 
Variable Data 
Variable Data 



USAGE 

Absolute 

Relocatable 

Absolute 

Relocatable 

Absolute 

Relocatable 
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3.2 INTER-DECK ADDRESSING 



This section Is devoted to a description of the several 
alternatives available for transmitting Information between program 
decks. As before, a deck Is defined as a sequence of source 
statements, terminated by an END statement. 



3.2.1 Entry Points 



Symbol s may be 
thus effectin 
programs. The 
program is a 
Linkage Editor 
load time, 
defined, i t mu 
the ENTRY As 
names an entry 
symbol in orde 
The Assembler 
transmission t 



defined in one program and r 
g symbolic linkages between 

linkages can be effected 
ble to provide information 

program, which resolves thes 
In the program (deck) whe 
st also be identified to the 
sembler operation. It is ide 

point, which means that anot 
r to effect a jump operation 

places this information 
o the Linkage Editor. 



eferred to in another, 
independently assembled 
only if the Assembler 
about the symbol to the 
e linkage reference at 
re the linkage symbol is 
Assembler by means of 
ntifted as a symbol that 
her program may use that 
or a data reference, 
in the object deck for 



3.2.2 External Symbols 



is used in a program deck (i.e. appears in an operand 
is not defined in the same program deck, the Assembler 
it represents a symbol defined as an entry point in 
another program deck (see previous paragraph). It is identified 
then as an external or virtual symbol. The Assembler places this 
information in the object deck for transmission to the Linkage 
Editor, which resolves these 1 Inkage references at load time. 



If a symbol 
field) but 
assumes that 



If, at load time, no entry point can 
symbol, an appropriate error message 
Editor. 



be found for an external 
is printed by the Linkage 
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3.2.3 Block Data 



Symbols may be made global by defining them In a block data deck* 
A block data deck is defined by placing a BLKDTA Pseudo-Op at the 
beginning of the deck and ending with the ENDBLK Pseudo-Op. 
Symbols defined in a block data deck may be referenced in any deck 
in that assembly provided that the block data deck has been 
assembled prior to the reference of any of the symbols. To avoid 
assembl Ing the block data deck each time a block data symbol is 
referenced the block data symbols may be saved and retrieved in 
subsequent assemblies by using control card options. A block data 
deck should not appear in the Assembler input stream if the control 
card calls for the retrieval of an earlier Block Data deck. 
Symbols referred to in a non-block data deck/ that are defined in 
block data, are so indicated In the cross reference listing. 

The following rules apply to the use of block data symbols: 



A symbol defined locally In a subroutine 
definition of the symbol In a block data deck. 



overrides the 



Symbols defined in a block data deck may not appear in the 
operand field of an EQU Pseudo-Op In another deck. Symbols In 
the operand field of an EQU Pseudo-Op which are not locally 
defined are considered to be external symbols by the Assembler. 



Symbols that have to be defined before they 
operand of ORG) cannot be block data symbols. 



are used (e.g. 
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3.3 LINKAGE EDITOR PROGRAM 



The output of the SKC3120 Assembler Program Is an Object Module 
which contains object code (binary machine language) for each 
instruction or data word designated in the source deck. However, 
the relocatable code will not yet be assigned a memory address and 
any instructions which directly reference relocatable or external 
operands will have an unresolved operand address field. The Object 
Module also contains information on the number and type of location 
counter under which each word was assembled. All the Object 
Modules comprising a program are processed by the Linkage Editor 
Program which assigns an absolute memory address to each data and 
instruction word and resolves all operand address references to 
relocatable or external operands. The result is a Load Module 
which contains absolute machine code with its assigned memory 
address. The Load Module can be directly loaded into the SKC3120 
Computer. An outline of the process is shown in figure 3-1. 

Further description of the Linkage Editor Program and the Linkage 
Editor output can be found in the SKC3120 Assembler/Linkage 
Editor/Simulator Users Manual (Y2U0A3O1M0811) . 
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SOURCE 
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MODULE 
FILE 
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(LOAD MODULE [ 
I (RELOCATABLE)^ 
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COMPUTER 
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LINKAGE- 
EDITOR 




SIMULATOR 
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Figure 3-1. Support Software Data Flow 
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k. MACHINE LANGUAGE INSTRUCTIONS 

This section describes the rules for preparing source language 
statements which, when processed by the Assembler program, produce 
SKC3120 machine language instructions. The Assembler uses the 
mnemonic in the operation field of a KAL31 statement to generate 
the operation code of the corresponding machine instruction. The 
operand field of a KAL31 statement contains any designator for 
other fields in the machine instruction. 

In describing the syntax of the operand field, some general 
notation will be used. Lower case characters are employed in a 
symbol which represents a family of possible source code items. 
For example, u represents any valid KAL31 expression such as: X, 
RANGE, Y2, X+Y, R-9, etc. In general, upper case characters are 
used to indicate source code in a literal sense. Several other 
notations are employed in describing the source code syntax. The 
more general of these are defined below: 

NOTATION DEFINITION 



() designates the contents of the register or instruction 
subfield which is specified within the parentheses. 

u represents an absolute or relocatable expression (see 
Section 2.2) which is used to define the address field 
in a symbolic instruction. 

N designates the address field in object code 
instructions. 

K designates the count field in object code 
instructions. 

XR specifies the active index register. 

IXR specifies the inactive index register. 

Bl specifies base register one. 

B2 specifies base register two. 

Further notation used in specific statement descriptions is defined 
in the relevant sections. The descriptions for the SKC3120 
instructions are grouped according to source statement syntax and 
object code format. Each group is discussed separatly below. 
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U.l ARITHMETIC INSTRUCTIONS 

The majority of SKC3120 machine Instructions are In the arithmetic 
group. The arithmetic group can be divided into sub-classes, In a 
natural way, which parallels the machine code Instruction format. 
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4.1.1 Operation Field 



This section lists all the valid mnemonic code entries for the 
operation field of an arithmetic instruction. 



MNEMONIC 



OPERATION SUMMARY 



ADA 

ADAB 

ADAX 

ADF 

ADFI 

ADM EM 

AND 

AN DM 

CMS 

DIV 

DSZ 

INCMS 

LDA 

LDAB 

LDABI 

LDABX 

LDAM 

LDAX 

MLF 

MLFI 

MUL 

MULAB 

MULX 

OM 

ORM 

SBA 

SBAB 

SBAX 

SBF 

SBFI 

SKPMZ 

SKPM1 

STA 

STAB 

STAB I 

STABX 

STAX 

STB 



Add fixed point to 
Add fixed point to 
Add fixed point to 
Add floating point 
Add floating point 
Add fixed point to 
Logical AND 
Logical AND 



A-Register di 
AB Register d 
A-Register In 
to AB Registe 
to AB Registe 
memory direct 

to A-Register direct 

to memory based 



rect 
irect 
dexed 
r di rect 
r indirect 



Compare fixed point and skip if 
Divide fixed point AB Register d 
Decrement memory fixed point and 
Increment fixed point and skip i 
Load A-Register direct 
Load AB Register direct 
Load AB Register indirect 
Load AB Register indexed 
Load A-Register immediate 
Load A-Register indexed 
Multiply AB Register floating po 
Multiply AB Register floating po 
Multiply A-Register fixed point 
Multiply AB Register fixed point 
Multiply A-Register fixed point 
Logical OR A-Register direct 
Logical OR to memory based 
Subtract fixed point from A-Regi 
Subtract fixed point from AB Reg 
Subtract fixed point from A-Regi 
Subtract floating point from AB 
Subtract floating point from AB 
Skip on (memory) ■ based 
Skip on (memory) - 1 based 
Store A-Register direct 
Store AB Register direct 
Store AB Register indirect 
Store AB Register indexed 
Store A-Register indexed 
Store B-Register direct 



(A) < (memory) 
irect 

skip if (memory) =0 
f result > 



int di rect 
int indirect 
direct 
di rect 
indexed 



ster di rect 
ister direct 
ster indexed 
Regi ster di rect 
Regi ster indi rect 
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4.1.2 Operand Field 



The operand field of most arithmetic instructions may be an 
expression, represented by u, or either a decimal integer or 
set-symbol , represented by z. In some instruct ions, an operand 
field is not required. The syntax of an expression, decimal 
integer, and set-symbol is described in section 2.2.2. 

The interpretation of the operand field is governed by the mnemonic 
appearing in the operation field of the arithmetic instruction and 
is presented in Table k.l. 



F4202-I 2/75 



o 



MNEMONIC TYPE 



Table k.l Arithmetic Instructions 
INTERPRETATION NOTES 



i 

U1 



Direct u specifies the effective 
address of the operand; 
u -> N 



Immediate u specifies the immediate 
operand; u -> N 

Indexed u forms an explicit displacement; 
Type 1 u -> N 

Indexed u forms an explicit displacement; 
Type 2 u -> K 

Indirect z forms an explicit displacement; 
z -> K 

Based z forms an explicit displacement; 
z -> K 

Global u specifies the effective 
Direct address of the operand; 
u -> N 



This form valid for: ADA,ADAB, 
AND, ADMEM, D I V, DSZ, CMS, STAB, 
MUL, LDA, LDAB, OR, STA, STB, SBA, 
SBAB. 

This form valid for: LDAM. 



This form valid for: LDAX,STAX, 
ADAX,SBAX,MULX. 

This form valid for: LDABX,STABX. 



This form valid for: ADFI,MLFI, 
LDABI,STABI,SBFI. 

This form valid for: ORM,ANDM, 
SKPMZ,SKPM1,INCMS. 

This form valid for: ADF,SBF, 
MLF,MULAB. 



* x 

m m 

5* 

-n z 
q o 
d m 

E o 
< o 

I- 

o > 
z z 

-< 



O 

> 

O 



O 



3D 
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Some arithmetic instructions are double word machine code 
instructions. For INCMS/ the second word is generated via the 
specification of a PTR instruction immediately following its 
occurence in the code stream. (see Section 5.2.7 for PTR syntax). 
The instructions ANDM / 0RM / SKPMZ, and SKPM1 require a data 
generation Pseudo-Op to define the second word of the machine 
instruction (see Section 5.2 for data generation Pseudo-Op syntax). 
The instructions ADF, SBF, MLF, and MULAB are also double word 
instructions/ however, the Assembler automatically generates the 
second word of the machine instruction using the specified operand. 
Figure k.l presents val id forms for representatives in each of the 
double word arithmetic instruction classes. 



Figure k.l Typical Arithmetic instructions 



LABEL 


OPERATION 


OPERAND 


ONE 


LDA 


ALPHA+1 


TWO 


STAX 


k 


THREE 


MULX 


SETSYM 


FOUR 


ADFI 


10 


FIVE 


ADF 


OPRADR+10 


SEVEN 


ANDM 


SETsym 




DEC 


16 


EIGHT 


INCMS 


SETSYM 




PTR 


OPRADR+10 
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It. 2 JUMP INSTRUCTIONS 



All jump instru 


dest inat ion 


add 


some of tli 


le 


expression f 


r iel 


In the discuss 


to refer to 


the 


the Jump to 


Sub 


express ions 


(u 


in the Jump 


Ind 


specifies th 


le a 


effected. 





ctions, except for Jump Indirect (Jl), specify a 
ress in the operand field of a KAL31 statement. For 
jumps (JEQ, JGE, JGT, JLE, JLT, JNE, and JU), the 
d (u) generates an implicit (or relative) address, 
ion of relative jumps, the symbol f loc f will be used 
location of the instruction following the jump. In 
routine (JS) instruction, one of the sub-field 
), generates an explicit (or global) address, while 
irect (Jl) instruction, the expression field (u) 
ddress of a pointer word through which the branch is 



fe.2.1 Operation Field 



The valid mnemonic code entries for the operation field of 
instruction are listed below. 



j ump 



MNEMONIC 



OPERATION SUMMARY 



JEQ 

JGE 

JGT 

J I 

JLE 

JLT 

JNE 

JS 

JU 



Jump 
Jump 
Jump 
Jump 
Jump 
Jump 
Jump 
Jump 



relative 
relative 
relative 
Ind! rect 
relative 
relative 
relative 



if 
if 
if 

if 
if 
if 



(A) 
(A) 
(A) 



(A) 
(A) 
(A) 



regi ster 
regi ster 
regi ster 



.EQ. 
.GE. 
.GT. 



global di rect 



Uncondi tional jump 



register . LE. 

register .LT. 

register .NE. 
to subroutine 
relative 













^. 2. 2 Operand Field 



The operand field of most jump instructions consists of a single 
expression, represented by u. The Jump to Subroutine instruction 
operand field consists of two expressions, represented by u,ul. 
The interpretation of the expression(s) is governed by the mnemonic 
appearing in the operation field of the jump instruction and is 
presented in Table k.2. 
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Table k.2 Jump Instructions 



MNEMONIC TYPE INTERPRETATION 



NOTES 



Jump relative 



Jump direct 



Jump Indirect 



u forms a signed relative 
address; +O)|u-loc| -> N 



u specifies the explicit 
destination address 
ul specifies the effective 
address where the return 
address is to be stored; 
ul -> N 



This form valid for: 
JEQ / JGE / JGT / JLE / JLT / 
JNE,JU. 

this form valid for: 
JS 



u specifies the effective This form valid for: 
address of the pointer word Jl 
through which the branch Is 
effected; u -> N 



Figure k.2 presents valid forms for representatives in each of the 
sub-classes of the jump instructions. 



Figure ^.2 Typical Jump Instructions 



LABEL 



OPERATION 



OPERAND 



ONE 
TWO 
THREE 
RFOUR 



JU 
JS 
Jl 
JLT 



SINE,RETADR 

RETADR 

LABEL 
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If. 3 INDEX REGISTER INSTRUCTIONS 



The instructions (EXR, 
reference group (see 
Instructions) operate on 



LDR, STR, ADX, DXS) in the nonmemory 
Section k.5 for descriptions of these 
the active index register. 



The KAL31 statements discussed in this section (LDX, LDXM, STX) 
along with the previously noted instructions constitute the index 
register instructions. 

h. 3.1 OPERATION FIELD 



The mnemonic code entries for the index 
discussed in this section are listed below. 



regi ster instructions 



MNEMONIC 



OPERATION SUMMARY 



LDX 

LDXM 

STX 

k. 3. 2 Operand Field 



Load Active Index Register from memory 
Load Active Index Register immediate 
Store Active Index Register into memory 



The operand field of the index register instructions is similar to 
that of the arithmetic instructions. The operand field consists of 
an expression, represented by u, or either a decimal integer or 
set-symbol, represented by z. The interpretat ion of the operand 
field is presented in Table J*. 3. 



Table I*. 3 Index Register Instructions 
MNEMONIC TYPE INTERPRETATION NOTES 



Direct u specifies the effective 
address of the operand; 
u -> N 

Immediate z specifies the immediate 
operand; z -> K 



This form 
LDX,STX 



This form 
LDXM. 



val id for s 



val id fort 
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Figure k.3 presents valid forms for representatives in each of the 
sub-classes of the index register instructions. 

Figure i».3 Typical Index Register Instructions 

LABEL OPERATION OPERAND 



ONE LDX TABLE+l* 

TWO LDXM SETSYM 
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k.k SHIFT INSTRUCTIONS 
4.i*.l Operation Field 



This section lists all valid mnemonic entries for the operation 
field of the shift instructions. 



MNEMONIC OPERATION SUMMARY 



SDX Variable shift (indexed) 

SLC Shift A-Register left circular 

SLL Shift A-Register left logical 

SLLD Shift AB Register left logical 

SRA Shift A-Register right arithmetic 

SRAD Shift AB Register right arithmetic 

SRC Shift A-Register right circular 



k.k.2 Operand Field 



The operand field of a shift instruction must be either a decimal 
integer or set-symbol, represented by z, with one exception; SDX 
does not require an operand. 

Figure k.k presents valid forms for the shift instructions. 
Figure k.k Typical Shift Instructions 
LABEL OPERATION OPERAND 



ONE SLLD 10 

TWO SRC SETSYM 

THREE SDX 
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k.5 NON-MEMORY REFERENCE INSTRUCTIONS 



U . 5 . 1 Operation Field 



This section lists all valid mnemonic entries for the operation 
field of the non-memory reference instructions. 



MNEMONIC 



OPERATION SUMMARY 



ABSF 

ADC 

ADX 

ATB 

ATB1 

ATB2 

ATP 

ATX 

ATY 

BTA 

B1TA 

B2TA 

CFX 

CLA 

CLB 

CMA 

CPA 

CPAB 

CXF 

DPI 

DXS 

EAB 

EPI 

EXR 

FNEG 

HLT 

LDR 

NOP 

PTA 

SBC 

STR 

TRAP1 

TRAP2 

TRAP3 

TRAP4 

XTA 

YTA 



Floating absolute AB Register 
Add fixed point carry to A-RegJster 
Add A to Active Index Register 
Move A to B-Register 

Bl Register 

B2 Register 

PC Register 

Active Index 



Move A to 

Move A to 

Move A to 

Move A to 

Move A to Inactive Index 

Move B to A-Register 

Move Bl to A-Register 

Move B2 



Regi ster 
Register 



to A-Register 
Convert floating point 
Clear A-Register 

B-Register 

complement 

complement 

complement 



to fixed point 



Clear 

One's 

Two's 

Two's 

Convert 

Disable 



A-Register 

A-Regi ster 

AB Register 
fixed point to floating point 
program interrupts 



Decrement active Index Register 

Exchange A-Register and B-Register 

Enable program interrupts 

Exchange Active and Inactive Index Registers 

Floating negate AB Register 

Halt 

Move A to B, PC, Bl, B2, I XR/ or XR Registers 

No operation (equivalent to SRC 0) 

Move PC to A-Register 

Subtract fixed point carry from A-Register 

Move B, PC, Bl/ B2/ IXR/ or XR to A-Register 

Trap one 

Trap two 

Trap three 

Trap four 

Move active Index Register to A-Register 

Move Inactive Index Register to A-Register 
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I* • 5 . 2 Operand Field 



Most nonmemory reference Instructions do not employ an operand 



field since they have no matching instruction subfields 
secondary (and tertiary) operation code. The exceptions 
TRAP2) require an operand field to define an instruction 
The operand field designator is either a decimal 
set-symbol, represented by z. 



beyond the 

(LDR, STR, 

subf ield. 

integer or 



Figure U.5 
sub-class of 



presents valid forms for representatives 
the nonmemory reference instructions. 



in each 



Figure **„5 Typical Nonmemory Reference Instructions 



LABEL 



OPERATION 



OPERAND 



ONE 
TWO 
THREE 



ABSF 

LDR 

TRAP2 



SETSYM 
5 
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4.6 INPUT-OUTPUT INSTRUCTIONS 
4.6.1 Operation Field 



This section lists all the valid mnemonic entries for the operation 
field of the Input-output Instructions. 

MNEMONIC OPERATION SUMMARY 



DIAX Input data to A-Register Indexed 

DOAX Ouptut data from A-Register Indexed 



4.6.2 Operand Field 



The operand field for the DIAX, DOAX instructions must be an 
expression, represented by u. The expression (u) defines a 
relative device code in the instruction subfield. 

The target device code of an Input-output instruction is computed 
at execution time, using: 

dc = u + (XR) 
Figure 4.6 presents valid forms for the input-output instructions. 
Figure 4.6 Typical Input-Output Instructions 
LABEL OPERATION OPERAND 



ONE DIAX VIRTUAL+7 

TWO DOAX SETSYM 
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k.7 BLOCK TRANSFER INSTRUCTION 

The block transfer (MOV) instruction moves a block of data or 
instructions from one region of memory to another. The source and 
destination addresses and the number of words to be transferred 
must be preloaded into the B, A, and XR registers, respectively. 

k.7.1 Operation Field 



MNEMONIC OPERATION SUMMARY 

MOV Block transfer 

k. 7. 2 Operand Field 



Specification of an operand in the operand field is not required. 
Figure k.7 presents the valid form of a block transfer instruction, 

Figure k.7 Typical Block Transfer Instruction 

LABEL OPERATION OPERAND 

ONE MOV 
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5. ASSEMBLER OPERATIONS 



In the Assembler some operations generate executable code, some 
allocate storage, and some initialize location counters. All 
Assembler directives which do not cause the Assembler to generate 
instructions are termed Pseudo-Operations. Table 5-1 lists and 
summarizes the Assembler-Operations. In the summary and subsequent 
subsections, the following notation is employed. 

u represents an absolute or relocatable expression 
as defined in Section 2.2.2 

v represents a single virtual (or external) symbol 

I OR operator - designates a choice of one of the two items 
separated by the vertical bar 

n represents a decimal integer ranging from to 2k 
if designating a location counter 

[ ] designates enclosed items as optional 

d represents a FORTRAN decimal integer. A FORTRAN decimal 
integer is a string of digits, through 9 which may 
optionally be preceded by a p1us(+) o rminus(-) sign. A 
decimal integer must not be terminated by a decimal point. 

f represents a floating real number in FORTRAN "REAL 11 
format or a decimal integer 

h represents up to four hexadecimal digits 

aa...a represents a string of alphanumeric characters 

op represents an operand address designation in 
the same format as the operand field of a 
basic arithmetic instruction 

s represents a KAL31 symbol or label 

st represents a set symbol or temporary symbol 

As in the description of the machine language instruction formats, 
lower case characters are used to form symbols which represent a 
family of possible source code items. In general, upper case 
characters are used to indicate source code in the literal sense. 
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LABEL 
FIELD 


OPERATION 
FIELD 


OPERA 
FIELD 


[s] 


BES 
BLKDTA 


d|st 


[s] 


BSS 


d|st 


[s] 


DEC 


d 


[s] 


DECD 


d|f 
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TABLE 5-1. SUMMARY OF ASSEMBLER PSEUDO-OPS 

SUMMARY 



Reserve next d locations for 
scratch data (see note 3) 

Start a Block Data Deck 

Reserve next d locations for 
scratch data (see note 2) 

Convert d to binary and insert 
at current location 

Convert d|f to floating; insert 
double word binary result 
in reverse order into current 
and following locations 

Print next line of assembly 
at top of page 

End of deck* Terminate assembly, 
starting address at s 

Terminate a Block Data Deck 

Each listed symbol (si..) is 
defined as an ENTRY point 

Assign the value of u (om v) 
to the symbol s 

Convert h to binary and insert 
at current location 

Resume 1 i sting after UNLI ST 

Set current Location Counter to d 

Insert Pointer to operand address 

Convert f to binary, shift d 
places, insert in current 
location 





EJECT 






END 


[s] 




ENDBLK 






ENTRY 


si, s2. . . 


s 


EQU 


u| V 


[s] 


HEX 
LIST 


h 


Is] 


ORG 


d|st 


[5] 


PTR 


op 


[s] 


SCLB 


f,d 
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TABLE 5-1. SUMMARY OF ASSEMBLER PSEUDO-OPS, CON f T. 



LABEL OPERATION OPERAND 

FIELD FIELD FIELD 

[s] SCLBD f,d 

SCLW fl,f2 

SCLWD fl,f2 



[s] 
[s] 



St 



St 



SUMMARY 

Convert f to binary, shift d 
places; insert double womd In 
reverse order Into current and 
fol lowing locations 

Divide fl by the LSB, f2; insert 
binary result in current location 

Divide fl by the LSB,f2; insert 
double word binary result 
in reverse order into current 
and following locations 

Assign the value of u|d as the 
temporary value of st 

Assign h as the temporary 
value of st 

Generate d blank lines in 
assembly 1 i sting 

Place a title aa...a on each page 
of assembly 

Suspend listing source statements 
during assembly 

Subsequent instructions or data 
under nth (or previous) 
location counter 

Notes: 

1, Symbol s in label field Is set equal to current value of 
location counter unless otherwise noted, 

2V Symbol s in label field is set equal to first location in 
group. ' > 

3. Symbol s in label field is set equal to the last location in 
group plus 1. 



SETD 


u|d 


SETX 


h 


SPACE 


d 


TTL 


aa...a 


UN LI ST 




USE 


nIPREVIOUS 
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5.1 LOCATION COUNTERS 



This section describes the operation which can activate a location 
counter during an assembly (USE) as well as the operation (ORG) 
which can effect the value of an active location counter. The 
Assembler provides 25 location counters (numbered to 2k) which 
can be activated by the user. All the code generated under a 
single location counter will be allocated to a contiguous area of 
memory. However, the source code under a single location counter 
need not be consecutive in the source deck. The sequence of source 
code is typically interrupted by the activation of other location 
counters and then subsequently reactivated. 

The principal purpose of location counters is to segregate 
different memory allocation types for separate action by the 
Linkage Editor. 

Because of the read-only-memory feature of the SKC3120 Computer and 
the resulting Assembler/ Linkage Editor design, any one location 
counter should control only constants or variables but not both. 
The first instruction or data al location fol lowing a USE operation 
which designates a given location counter for the first time, 
determines whether the words allocated will be placed in protected 
(read-only) memory or not. Protected memory should contain only 
instructions and constant data. Unprotected memory can be writtten 
into as well as read out of and, therefore, should only contain 
variables. If the user violates this separation rule, he may find 
out, at execution time, that his "protected 11 variables cannot be 
stored into or his "unprotected 11 constants were inadvertently 
destroyed during execution. 

For more details on the location counter allocation process, see 
Section 3.1. 
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5.1.1 ORG - Specify an Absolute Origin for the Program Segment 



The ORG Pseudo-Op redefines the value of the current location 
counter to be the absolute address specified. The format of this 
instruction is: 



LABEL FIELD 



Symbol (Optional ) 



OPERATION FIELD 



ORG 



OPERAND FIELD 



d|st 



where: 



d represents a FORTRAN decimal integer 

st represents a set symbol or temporary symbol 



The current location counter 
specified and the next i 
location counter will be 
Location counters are always 
ORG Pseudo-Op. If there 
defined as this new origin, 
effect will be assigned 
counters remain unaffected, 
coded following the first 
counter. 



will be reset to the absolute address 
nstruction to be assembled under this 
assigned to that absolute address, 
relocatable unless modified via the 
is a symbol in the label field it is 
All symbols defined while ORG is in 
absolute locations. Other location 
The ORG should be the first operation 
USE statement for an absolute location 
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5.1.2 USE - Start Use of Location Counter 



The USE Pseudo-Op specifies the location counter under which the 
following sequence of instructions or data is to be assembled. The 
format of the instruction is: 



LABEL FIELD 



(blank) 



OPERATION FIELD 



USE 



OPERAND FIELD 



n | PREVIOUS 



where: 



n represents a decimal integer ranging from to 2** 



When the operand f i el 
which of the 25 1 
activated. The locat 
USE is encountered 
previously specified) 
"previous 11 counter, 
memory allocation for 
next USE operation is 
selected, the previou 
Note that only one 
time. Consequently, 
is not permi tted. 
example: 



d contains a decimal integer, it designates 

ocation counters (numbered 0-2«O should be 

ion counter in control up to the time the 

(location counter is used if none is 

is suspended and temporarily preserved as the 

Location counter n Is activated to control 

the fol lowing instruct ions or data, until the 

encountered. If the USE PREVIOUS option is 

sly suspended location counter Is reactivated. 

suspended location counter is preserved at one 

nesting of these suspended location counters 

The following sequence is provided as an 



This series of 
instructions 



is equivalent to 

this series of 

instructions 



USE 1 



USE 1 



USE 2 



USE 2 



USE PREVIOUS 



USE 1 
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5.2 DATA GENERATION OPERATIONS 



Memory allocation Pseudo-Ops are used to reserve data storage for 
constant data (usually In protected memory) and variable data 
words. The current location counter controlling the respective 
storage areas Is incremented by the number of words generated by 
the Pseudo-Ops. BSS and BES allocate blocks of storage for 
variable data. Constant data Is allocated by DEC, DECD, HEX, SCLB, 
SCLBD, SCLW, SCLWD, and PTR. 

5.2.1 DEC - Decimal Data Definition 



The DEC Pseudo-Op Is used to enter a fixed point binary data word 
Into a program. The data word Is expressed as a decimal integer in 
the source coding. If there is a symbol in the label field, it Is 
assigned to the address of the data word generated. 



LABEL FIELD 



Symbol (Optional ) 



OPERATION FIELD 



DEC 



OPERAND FIELD 



whe re : 

d represents a FORTRAN decimal integer 

The maximum absolute value of a decimal integer permitted by the 
DEC pseudo operation is (2**(n-l) )-l, where n is the width in bits 
of a data word. Integers are Internally represented by a right 
justified binary equivalent. Negative numbers are represented In 
their two's complement form. 



Examples of the DEC Pseudo-Op are: 
LABEL OPERATION OPERAND 



INTGR1 
INTGR2 
INTGR3 



DEC 
DEC 
DEC 



52 

-52 

19 



RESULTING 
(HEX) MEMORY WORD 

003U 
FFCC 
0013 
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5.2.2 HEX - Hexideclmal Data Definition 



THe Hex Pseudo-Op is used to enter binary data expressed in 
hexadecimal digits. The digits are: 0-9 and A-F, where 0-9 have 
the same meaning as decimal digits 0-9/ and A-F have the decimal 
values 10-15 respectively. This directive is used to generate 1 
word of constant value. If there is a symbol in the label field, 
it is assigned to the address of the data word generated. The 
format of this Pseudo-Op is: 



LABEL FIELD 



Symbol (Optional ) 



OPERATION FIELD 



HEX 



OPERAND FIELD 



where: 

h represents up to four hexadecimal digits 
Examples of the HEX Pseudo-Op: 
LABEL OPERATION OPERAND 



ABC 



BA359E 



ALPHA 


HEX 


BETA 


HEX 


GAMMA 


HEX 



RESULTING 
(HEX) MEMORY WORD 

OABC 
0000 
359E 



NOTE: The hexadecimal characters in the operand field are right 
justified with truncation on the left if more than one memory word 
is specified (see the third example above). 
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5.2.3 SCLB - Binary Scale Operation 



The SCLB Pseudo-Op is for the user's convenience when generating 
fixed point constants. The user specifies a decimal number and the 
scaling factor, and the Assembler performs the appropriate shift to 
create the scaled number and assigns storage for the data. If 
there is a symbol in the label field, it is assigned to the 
location of the data word generated. The format is as follows; 



LABEL FIELD 



Symbol (Optional ) 



OPERATION FIELD 



SCLB 



OPERAND FIELD 



f,d 



where : 



f represents a FORTRAN 
to be generated 



real number which designates the number 



d represents a FORTRAN integer constant (in 
+64) which designates the scaling factor 



the range -6** to 



The scaling factor may be interpreted either of two ways. It is 
either the number of non-sign positions to the left (or to the 
right, if scale factor is negative) of the specified binary point, 
or it is the number of bits the generated word is right shifted (or 
left shifted, if negative) out of normal position. See examples 
below. 



The number generated by 
format. If the first 
generated will be the 
positive number with the 



the Assembler will be in fixed-point 
subfield is a negative number, the number 
two f s complement of the corresponding 
same seal ing factor. That is, 



SCLB -N,B * -(SCLB N,B) 

For futher clarification of the use of the 
operation, consider the following example: 



SCLB (Binary Scale) 
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Example 1 

ALPHA SCLB 1.5,1* 

bit value 0000 11000000000 
bit pos. 1 2 3 k 5 6 7 8 9 10 11 12 13 Ik 15 



BIT POSITION k HAS THE VALUE 
BIT POSITION 5 HAS THE VALUE 



1 x 2**0 =1.0 
1 x 2**-l= .5 



1.5 



A scaling factor of k causes the number to be 
places to the right of its normalized position, 
value 2**0 and bit position 5 is 2**(-l). 
between bit positions k and 5. 



positioned k bit 

Bit position k has 

The binary point is 
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5.2.1* SCLW - Weighted Scale Operation 



The SCLW Pseudo-Op is for the user's convenience when generating 
fixed point constants. It is an alternate to SCLB. The user 
specifies a decimal number and the value, or weight/ of the least 
significant bit (LSB). If there is a symbol in the label field, it 
is assigned to the location of the data word generated. The format 
is as fol lows : 



LABEL FIELD 



Symbol (Optional ) 



OPERATION FIELD 



SCLW 



OPERAND FIELD 



fl,f2 



where: 

fl represents a FORTRAN 
to be generated, and 



real number which designates the number 



f2 represents a FORTRAN real number which designates the 

weighting factor. The weighting factor can be interpreted as 

the value associated with the least significant bit. See 
examples below. 

The number generated by the Assembler will be in fixed-point 
format. If the signs of the two subfields of the operand differ, 
the Assembler wi 1 1 generate a negative number in. two's complement 
form. The fol lowing relationships hold true. 



SCLW 


-N,-W 


- 


SCLW N,W 


SCLW 


-N,W 


- 


-(SLCW N,W) 


SCLW 


N,-W 


- 


-(SCLW N,W) 



In all cases, the number generated is equal to the value of 
first subfield, adjusted according to the weighting factor, 
further clarification, consider the following examples: 



the 
For 
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Example 1 

ALPHA SCLW 1.5,-5 

bit value 
bit pos. 1 2 3 k 5 6 7 



00000011 
8 9 10 11 12 13 Ik 15 



BIT POSITION II* HAS THE VALUE 0.5 x 2**1 
BIT POSITION 15 HAS THE VALUE 0.5 x 2**0 



Example 2 

BETA SCLW 1.5,. 0625 



1.0 
.5 

1.5 



bit value 
bit pos. 1 

BIT POSITION 
BIT POSITION 




3 




k 




5 




6 



000011000 
7 8 9 10 11 12 13 14 15 



11 HAS THE 

12 HAS THE 



VALUE 
VALUE 



.0625 x 
.0625 x 



Example 3 

GAMMA SCLW 24.0,1.2 

bit value 
bit pos. 12 3 




k 5 6 7 8 



BIT POSITION 11 HAS THE VALUE 1.2 x 
BIT POSITION 13 HAS THE VALUE 1.2 x 



2**4 
2**3 



1.0 
.5 

1.5 



10 10 
9 10 11 12 13 14 15 



2**k 
2**2 



19.2 
4.8 

24.0 
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5.2.5 SCLBD - Double Length Binary Scale 



The SCLBD Pseudo-Op is similar to the SCLB Pseudo-Op. The format/ 
inputs and operation are the same as the SCLB except for the size 
of the data word and therefore/ the range of the operand value that 
i s input. 

The SCLBD Pseudo-Op will generate a double length data word. The 
double length word is stored in memory in reversed order, i.e., the 
least significant word in the first memory location, and the most 
significant word stored in the next memory location. 

5.2.6 SCLWD - Double Length Weighted Scale 



The SCLWD Pseudo-Op i s s imi lar to the SCLW Pseudo-Op. The format, 
inputs and operation are the same as the SCLW except for the size 
of the data word and therefore, the range of the operand value that 
i s input. 

The SCLWD Pseudo-Op will generate a double length data word. The 
double length word is stored in memory in reversed order, i.e., the 
least significant word in the first memory location, and the most 
significant word stored in the next memory location. 
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5.2.7 PTR - Pointer to Address 



The word generated by the PTR operation is not executed but is used 
as a pointer to another location. It is commonly accessed via 
indirect addressing which causes it to be interpreted as the 
operand address field of the original . Instruction". The PTR address 
field has the same syntax as the address field of a basic 
arithmetic instruction. 



LABEL FIELD 



I. 



Symbol (Optional ) 



OPERATION FIELD 



PTR 



OPERAND FIELD 



u | v 



where: 

u represents an absolute or relocatable expression 

v represents a single virtual (or external) symbol 

Note: The evaluated operand address should not exceed the 
addressing capacity of the machine. 
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5.2.8 DECD - Decimal Data Definition 



The DECD Pseudo-Op is 
word into a program, 
source coding. If an 
floating point const 
constant is stored in 
significant part of th 
most significant part 
label field, it is ass 
portion (exponent pa 
(see examples below) 



used to ente 
The data wo 
integer or 
ant is gene 
reverse orde 
e mantissa i 
to location 
igned to the 
rt) of the 



r a double length 
rd is expressed in de 

real number is s 
rated. The resultant 
r in memory, I.e., 
s assigned to locatio 
n+1. If there Is a s 
address of the least 

double word constan 



binary 


data 


cimal 


in the 


pecif I 


ed, a 


doubl 


e word 


the 


least 


n n, a 


nd the 


ymbol 


in the 


significant 


t generated. 



LABEL FIELD 



I Symbol (Optional ) 




OPERAND FIELD 



dlf 



where: 

d represents a FORTRAN decimal integer 

f represents a FORTRAN real number 

There are two components to f, a principal part and an exponent 
part. The principal part is a signed or unsigned decimal number of 
up to 18 decimal digits. It normally contains a decimal point 
which may appear at the beginning, at the end, or within the 
decimal number. If the exponent part of a real number Is present, 
the decimal point may be omitted, in which case it is assumed to be 
located at the right-hand end of the decimal number. 

The exponent part consists of the letter E followed by a signed or 
unsigned decimal integer. The exponent part may be omitted if the 



principal part contains a decimal point, 
immediately follow the principal part. The 
present, specifies a power of ten by which the 
be multiplied during conversion. The maximum 
number is limited to approximately 2**127 



I f used, i t must 
exponent part, if 
principal part wi 1 1 
range of a real 
by the size of the 



exponent field in an SKC3120 floating point binary data word. 
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Real numbe 
binary f 
character I 
must be ra 
is a bin 
bias of 12 
which ind 
greatest 
the small e 
Negative 
complement 
given in F 



rs are internally repre 
raction(the manti ssa) 
stic). The exponent 
ised so that when multi 
ary representation of 
8 i s added to the expon 
icates either a posi 
value of the exponent ( 
st value of the exponen 
numbers have their f 

form. Representation 

gure 5-1. 



sented in the form of a signed 
and a biased exponentCthe 
is the power to which the base (2) 
plied by the fraction/ the result 
the real value being expressed. A 
ent to form the characteristic 
tive or negative exponent; the 
+127) will be expressed as 255 and 
t (-128) will be expressed as 0. 
ractional parts represented in Two's 
of the floating point format is 



Figure 5-1. FLOATING POINT FORMATS 
I—- MANTISSA (FRACTIONAL PART) ■ 



IS | 
IG I 

IN | 

l_l 



15 MOST 
BITS OF 



SIGNIFICANT 
THE MANTISSA 



1 



I 8 LEAST SIGNIFICANT 
| BITS OF THE MANTISSA 

.1 . 



EXPONENT 
(8 bits) 



15 
16 BIT DATA WORD 



7 8 



15 
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The exponent bias can be represented as hexadecimal 80 (binary 
10000000) the most significant bit (MSB) is the high order bit of 
the exponent. Note the following examples: 

DESIRED POWER OF 2 CHARACTERISTIC IN BINARY 



2**(+127) 11111111 

2**(3) 10000011 

2**(2) 10000010 

2**(1) 10000001 

2**(0) 10000000 

2**(-l) 01111111 

2**(-2) 01111110 

2**(-3) 01111101 

2**(-128) 00000000 

For a complete illustration, four examples are given below 
including all combinations of signs. The decimal is given on the 
left and the hexadecimal (32 bit) equivalent is given on the right. 

EXAMPLE 1 0.75 x 2**(3) 60000083 

EXAMPLE 2 -0.75 x 2**(3) A0000083 

NOTE: The mantissa is in two's complement form because the number 
is negative. 

EXAMPLE 3 0.75 x 2**(-3) 6000007D 

NOTE: The mantissa is not in two's complement form since the 
number is positive. The characteristic is less than the bias value 
of 80 (hex), indicating a negative exponent. 

EXAMPLE k -0.75 x 2**(-3) A000007D 

NOTE: The mantissa is in two's complement form and the 
characteristic is less than the bias value of 80 (hex), Indicating 
a negative number and a negative exponent. 
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5-3 STORAGE ALLOCATION OPERATIONS 



Storage Allocation Operations are used to reserve data storage 
areas for constant data and variable data words. The current 
location counter controlling the respective storage area Is 
Incremented by the number of words generated by the Pseudo-Ops. 

5.3.1 BSS - Block Started by Symbol 



The BSS Pesudo-Op Is used to reserve an area of memory for use by 
the program as data storage or work area. The start location of 
the block is determined by the value of the current location 
counter at the time the BSS Pseudo-Op Is encountered. 

The format of this Pseudo-Op is: 



LABEL FIELD 



Symbol (Optional ) 



OPERATION FIELD 



BSS 



OPERAND FIELD 



d|st 



where : 



d represents a FORTRAN decimal integer 

st represents a set symbol or temporary symbol 

If there is a symbol in the label field, it is assigned to 
first location of storage reserved by the BSS Pseudo-Op, 
reserves a block of consecutive storage locations/ the length 
which is determined by the value in the operand field, 
example: 



the 

BSS 

of 

For 



ALPHA BSS 



20 



A block of 20 storage 
assigned to the first 
irii t ial ly cleared (i t 



locations is reserved and the symbol ALPHA is 
of these. These storage locations are not 
may not be assumed that they contain zeros). 
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5.3.2 BES - Block Ended by Symbol 



The BES Pseudo-Op Is used to reserve an area of memory for use by 
the program as variable data storage or work area. The start 
location of the block is determined by the value of the current 
Icoation counter at the time the BES Pseudo-Op is assembled. The 
format of this Pseudo-Op is: 



LABEL FIELD 



Symbol (Optional ) 



OPERATION FIELD 



BES 



OPERAND FIELD 



d|st 



where: 

d represents a FORTRAN decimal integer 

st represents a set symbol or temporary symbol 

If there is a symbol in the label field, it is assigned to the next 
location fol lowing the last location of the block. The BES 
Pseudo-Op reserves a block of consecutive storage locations the 
length of which is determined by the value in the operand field. 
For example in: 

ALPHA BES 20 

a block of 20 storage locations is reserved and the symbol ALPHA is 
assigned to the location after the last of the block, i.e. the 
21st location from the beginning. These storage locations are not 
initially cleared (it may not be assumed that they contain zeros). 

5.3.3 BLKDTA - Begin Block Data 

The BLKDTA Pseudo-Op Is used an as initiator for the block of data 
that will follow. All symbols defined within the block data will 
be globally defined. Only one BLKDTA Pseudo-Op may appear in a 
program and its format is as follows: 



LABEL FT ELD 



OPERATION FIELD 



BLKDTA 



OPERAND FIELD 
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S.k SYMBOL DEFINITION OPERATIONS 



Most operations may be used to define a symbol simply by placing 
the symbol to be defined In the label field of an operation. The 
symbol Is defined to be the value of the location counter in 
control at the time the symbol is encountered during assembly. 
However, the symbol definition Pseudo-Ops EQU, SETD, and SETX exist 
solely for the purpose of extending this symbol definition 
capabi 1 i ty. 

5.1*. 1 EQU - Equate Symbol to Expression 



The EQU Pseudo-Op is used to assign a value 
equal to the value of the expression in 
format of the EQU instruction is: 



to a symbol which is 
the operand field. The 



| LABEL FIELD 



I 



Symbol 




OPERAND FIELD | 

I 

I 
ulv | 



where: 



u represents an absolute or relocatable expression 

v represents a single virtual (or external) symbol 

Note that unlike most other operations/ EQU defines a symbol in the 
label field to have a value other than the current value of the 
location counter. (The other two such exceptional operations are 
SETD and SETX). EQU is also special in that the symbol (s) used In 
the expression in the operand field must have been defined In 
preceding source statements; that is, forward symbol reference is 
forbidden. 

Observe the following examples: 

Example 1 

ALPHA EQU BETA 



The value of ALPHA is set equal to the value of §€TA. 
a virtual (external) symbol. 



BETA may be 



5-20 



F4202-! 2/75 



THE SINGER COMPANY Y2U0A301M0810 

KEARFOTT DIVISION —-—-—-——-—^ *EV _ 

Example 2 

LDA BETA 
GAMMA EQU * 

STA DELTA 

If the instruction LDA BETA is assigned to location 0172 then GAMMA 
has the value 0173 and the instruction STA DELTA is assigned to 
location 0173. 

NOTE: If an asterisk (*) is used in the operand field, the value 
of the symbol is the present value of the current location counter. 

Example 3 

DELTA EQU ALPHA+BETA 

DELTA is set equal to the value of the expression ALPHA+BETA as 
evaluated at assembly time. Either ALPHA or BETA or both may be 
previously defined symbols or set-symbols; however, only one can be 
relocatable. Neither ALPHA nor BETA may be externally defined 
symbols. 
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5.1*. 2 SETD - Set Temporary Symbol to Decimal Number 



The SETD Pseudo-Op is used to define or redefine a temporary symbol 
for use in instructions as an element in the operand field. The 
format of the SETD Pseudo-Op is: 



LABEL FIELD 



Symbol 



OPERATION FIELD 



SETD 



OPERAND FIELD 



u|d 



where: 



u represents an absolute or relocatable expression 



d represents a FORTRAN decimal integer 



The use of the SETD Pseudo-Op assigns 
operand field to the symbol in the 1 
prior '•temporary" value of the symbol, 
value maintained by the symbol until 
SETD or SETX). In this manner, a set s 
may assume several values during as 
symbol is thus defined to be a set s 
elsewhere in the program as a conve 
referring to an absolute or relocatable 



the numeric value of the 

abel field regardless of any 

The new value becomes the 

it is redefined (by another 

ymbol or temporary symbol 

sembly of the program. If a 

ymbol, it cannot be used 

ntionaKor permanent) symbol 

memory address. 



The value of the symbol is the current value of the expression, u. 
All symbols employed in the expression must be previously defined 
set symbols. Neither externally defined symbols (virtual symbols) 
nor conventional symbols may be used in the expression. 
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5.4.3 SETX - Set Temporary Symbol to Hex Value 



The SETX Pseudo-Op is used to define a temporary symbol for use in 
instructions as an element in the operand field. The format of the 
SETX instruction is: 



LABEL FIELD 



Symbol 



OPERATION FIELD 



SETX 



OPERAND FIELD 



where 2 



h represents up to four hexadecimal digits 

The SETX Pseudo-Op assigns the binary integer specified by h as the 
value of the symbol in the label field regardless of any prior 
"temporary" value of the symbol. The new value becomes the value 
maintained by the symbol until it is redefined (by another SETD or 
SETX). In this manner, a set symbol or temporary symbol may assume 
several values during assembly of the program. If a symbol is thus 
defined to be a set symbol, it cannot be used elsewhere in the 
program as a conventional (or permanent) symbol referring to an 
absolute or relocatable memory address. 



Unl i ke the 
expressions 



SETD Pseudo-Op, the 
in its operand field. 



SETX Pseudo-Op may not have 
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5.5 SUBROUTINE OPERATIONS 



Subroutine directives are used to provide communication 
calling program and its subroutines. 

5.5.1 ENTRY - Entry Point Designation 



between a 



The ENTRY Pseudo-Op identifies a symbol as having the ability to be 
referenced by a routine other than the one in which it has been 
defined. The format of the ENTRY Pseudo-Op is: 



I 

I LABEL FIELD 



I 



(blank) 



I I 

I OPERATION FIELD | OPERAND FIELD 

.1 I 

i I 



I 



ENTRY 



sl,s2. . . 



where : 



sl,s2. 



are the symbols separated by commas 



These symbols can be any ordinary symbol defined in the program 
deck by having appeared in the label field of an instruction, 
Pseudo-Op, or macro. Data symbols as well as instruction labels 
may appear in ENTRY Pseudo-OPs to Indicate that they will be 
available to other subroutines as external symbols or references. 
However, it is more typically used to designate the starting 
location for a subroutine. Set-symbols are not permitted. 
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5.6 PROGRAM CONTROL PSEUDO-OPS 



Program Control Pseudo-Ops are used to control the Assembler's 
processing of the program. 

5.6.1 END - Program Terminator 

The END Pseudo-Op indicates to the Assembler that it should 
terminate the assembly of a program. The format of this 
instruction is: 



LABEL FIELD 



(blank) 



OPERATION FIELD 



END 



OPERAND FIELD 



Symbol (Optional ) 



When the Assembler reaches an END 
and if there is a symbol in the 
the Linkage Editor as the pointer 
program. Only one program in 



card, it terminates the 
operand field, it will be 
to the starting location 
any one computer load ma 



symbol in the operand field of the END Pseudo-Op, and that 
name of the main program of the load. All other subprog 
considered to contain only subroutines of the main program 
have blanks in the operand field. Each program or subprogr 
have an END Pseudo-Op, which must appear as the las 
statement. 

The comment field should not be used in an END statement. 

5.6.2 ENDBLK - Block Data Terminator 



assembly 

used by 

of the 

y have a 

is the 

rams are 

and must 

am must 

t source 



The ENDBLK Pseudo-Op is required as the terminator of the block 
data definition. All symbols defined within the block data will 
globally defined. Only one ENDBLK Pseudo-Op may 
program and its format is as follows: 



appear in 



be 

a 



LABEL FIELD 



(blank) 



OPERATION FIELD 



ENDBLK 



OPERAND FIELD 



(blank) 
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5.7 LIST CONTROL PSEUDO-OPS 



The List Control Pseudo-Ops allow the user to control the format of 
the program listing that Is output by the Assembler. These 
directives specify the contents of the list, the spacing of printed 
lines, page ejection and the printing of page titles. 

5.7.1 LIST - Resume Listing 



The LIST Pseudo-Op 
output fol lowing 
instruction i s: 



is used to resume the listing of the assembly 
an UNLIST Pseudo-Op. The format of the 



LABEL FIELD 



(blank) 



OPERATION FIELD 



LIST 



OPERAND FIELD 



(blank) 



5.7.2 UNLIST - Suspend Listing 



The UNLIST Pseudo-Op is used to suspend the listing of the assembly 
output. The format of this instruction is: 



1 1 1 1 

I LABEL FIELD | OPERATION FIELD | OPERAND FIELD | 
1 1 1 1 


1 1 1 1 
I (blank) | UNLIST | (blank) | 
1 1 1 1 



The UNLIST instruction does not appear in the listing, and source 
statements that follow are not listed until a LIST instruction is 
encountered in the assembly process. Instructions that follow the 
UNLIST are assembled even if they are not listed. 
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5.7.3 TTL - Define Page Title 



The TTL Pseudo-Op Is used to place a subheading or title on each 
page of the listing of the Assembler's output. The format of this 
instruction is : 



LABEL FIELD 



(blank) 



OPERATION FIELD 



TTL 



OPERAND FIELD 



Character String 



The string of characters of the operand field may contain any 
EBCDIC character, including embedded blanks. Each TTL Pseudo-Op 
causes page ejection and generates a subheading on each succeeding 
page until another TTL instruction Is encountered. Termination of 
the printing of a subheading is performed by a second TTL Pseudo-Op 
with an operand field containing blanks or a new title. 

The comment field cannot be used. 

5.7.1* EJECT - Start New Page 



The EJECT Pseudo-Op is used to cause the next line in the assembly 

listing to be printed at the top of a new page. The EJECT 

Pseudo-Op is not printed In the listing. The format of this 
instruction is: 



LABEL FIELD 



(blank) 



OPERATION FIELD 



EJECT 



OPERAND FIELD 



(blank) 
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5.7.5 SPACE - Skip Blank Lines 



The SPACE Pseudo-Op is used to generate any number of blank lines 
in the assembly listing, limited by the end of a page. That is, 
regardless of the number of spaces requested, the maximum effect is 
a page change. The format of this instruction is: 



LABEL FIELD 



(blank) 



OPERATION FIELD 



SPACE 



OPERAND FIELD 



n 



The number n indicates the number of blank lines that are to appear 
in the assembly listing. 
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6. THE ASSEMBLER OUTPUT LISTING 

Each page of the Assembler listing will consist of a heading and 
the side-by-side listing. The heading contains the Assembler 
version/ the deck name, title, and page number. The heading also 
labels the various sections of the side-by-side listing as follows: 



a. DIAGNOSTICS 



b. 


LINE 


c. 


AD RES 


d. 


DADRES 


e. 


LC 



f. 
g. 



PROGRAM 
SOURCE 



a sequence of zero to four one or two letter 
mnemonics for error messages 



line number 

absolute or 
hexadecimal 



relocatable address 



in 



absolute or relocatable address in decimal 
location counter 

1. LC * to 21* current location counter 

2. LC * -1 symbol defined is absolute (EQU 

only) 

3. LC ■ -2 symbol defined is a set-symbol 

W. LC * ** symbol defined is synonym for an 
external reference 

machine instructions or data 

symbolic instructions 



See the Appendices for a sample program listing and a 
Assembler Error Diagnostics. 



list of 
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6.1 ERROR MESSAGES 



After each Side-By-Side Object/Listing an expanded error message 
printout is provided if any errors occurred at assembly time. The 
error message printout consists of a heading, containing the 
deckname, followed by an ordered error message listing which 
contains the full error diagnostic and the line on which the error 
occurred. In addition, the Assembler provides an error message 
summary of the form 

**********THERE ARE xxxx ERROR(S) IN THIS ASSEMBLY********** 

at the end of all assemblies, xxxx is the sum of the errors that 
occurred in all the assemblies. 

6.2 CROSS REFERENCE 



Each page of the cross reference listing will consist of a heading 
and a sorted list of all symbols in the assembly. The heading 
contains the deckname and page number. The heading also labels the 
various columns of the cross reference as follows: 

a. RELATIVE ADDRESS OR SET VALUE 

al. HEX - value of symbol in hexadecimal. 

a2. DEC - value of symbol in decimal. 

If the symbol is undefined *****UNDEFINED***** is printed. 

b. LC - Location counter of the symbol 

c. VARIABLE NAME - One to eight character symbol names 

d. LINE NUMBERS OF OCCURRENCES 

dl. DEFINED - the line number at which the symbol is 
defined. If the symbol is a Block Data 
Symbol, BLKDTA appears in this entry. 

d2. REFERENCES - the line numbers of all references to 

the symbol . 
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APPENDIX A 
ASSEMBLER ERROR DIAGNOSTICS 
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The assembly errors which may be generated by a program are listed 
below. For a more detailed explanation see SKC3120 Assembler/ 
Linkage Editor/Simulator Users Manual Y2U0A301M0811. 



Error Description 

A Symbols have differing location counters 

AR Address out of Range 

BD More than one block data 

D Symbols in operand must be defined 

DC Invalid device code 

E Illegal Expression in Operand 

ES Entry Symbol is also a Set Symbol 

L Improper Label 

LC Illegal location counter number 

M Multiply Defined Symbol 

NE No end card 

OP Illegal OP Code 

OR Operand in Error 

R Attempt to mix Data/ I nstruct ions 

and Variables 

RE Origin out of range 

SH Shift count too large 

T Truncation Error 

UE Undefined Entry Point 
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APPENDIX B 
ASSEMBLER CONTROLS AND OPTIONS 
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$ASM 

The $ASM control card must precede each source deck to be 
assembled. This card causes the Assembler to process the source 
deck immediately following the $ASM control card in the input 
stream. An END Pseudo-Op card must be added to the end of the 
source program. This Pseudo-Op causes the Assembler to terminate 
the assembly process and return control to the control routine. 

the format of the $ASM control card is: 

column: 

12 3 l* 5 6 7 8 9 10 11 12 13 Ik 15 16 17 18 19 20 21 22 
$ A S M n n n n n n OPT IONS 

where : 

$ASM « Request for the Assembler function 

nnnnnn .« Source deck name (up to 6 alphabetic or numeric 
characters). Must begin in column 6 with a alphabetic 
character. 

OPTIONS = One letter Assembler option codes. Option codes must 
begin in column 16 and are written one code per column 
with no embedded blanks. Option codes are: 

D - No Object Deck (Object Deck-Default) 
L - Suppress Assembly 1 i sting (Li sting-defaul t) 
P - 16 Bit Data Option (19 Bit Data Option-Default) 
R - Retrieve Saved Block Data Symbols (Use instream 
Block Data Symbols or no Block Data Symbols- 
Default) 
S - Save Block Data Symbols (Do not save Block Data 

Symbols or no Block Data Symbols-Default) 
X - Suppress Assembly Cross Reference listing 
(Cross Reference listing-Default) 
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APPENDIX C 
SAMPLE PROGRAM LISTINGS 
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3 K f 3 o 
DICK NAMCb*UtILIT* 



ASSEMBLER VERSION 



1 



DIAGNOSTICS LINE AORES DADRE3 LC PROGRAM 









jasm utilit 




t 








USE 


1 


2 








ORG 


1402 


3 








ENTRY 


ATAN 


4 0057A 1 


a02 -1 




ATAN 


EQU 


* 


5 0057A J 


402 1 


1 0191C 




8TA 


RTEM3 


6 0057B j 


403 1 


I. 0?A4Q 




CLB 




7 0057C 1 


404 j 


I 0?802 




SLLD 


2 


8 0057D 1 


405 1 


i 0AA04 




AND 


HirrrF 


9 0057E | 


406 ] 


1 0191A 




STA 


RTEMl 


10 0057F j 


407 1 


I 0111A 




MUL 


RTEM1 


11 00580 1 


[408 j 


0^918 




STA 


RTEMg 


12 00581 j 


409 J 


0J212 




MUL 


UCT11 


13 00582 1 


1410 1 


0SA10 




ADAB 


UCT9 


14 00583 1 


[411 ] 


1 01118 




MUL 


RTEM2 


15 0058*1 1 


1412 1 


I O52OE 




SBAB 


UCT7 


16 00585 | 


[413 1 


1 OlllB 




MUL 


RTEM2 


17 00586 


1414 1 


1 OSAOC 




ADAB 


UCT5 


18 00587 


1415 I 


I Of 1 IB 




MUL 


RTEM2 


19 00588 1 


1416 1 


1 0«;20A 




SBAB 


UCTj 


20 00589 \ 


417 1 


1 OlllB 




MUL 


RTEH2 


21 0058A 


1418 1 


I 0SA08 




ADAB 


UCT1 


22 0058B 


1419 1 


1 OfllA 




MUL 


RTEMl 


23 0058C 1 


1420 1 


1 0*9lA 




STA 


RTEMl 


2a 0058D 1 


1421 1 


I 0<illC 




LDA 


RTFM3 


25 0058E 1 


1422 1 


1 0AA07 




AND 


H70000 


26 0058F | 


1423 1 


1 0t9lC 




STA 


R1EM3 


27 00590 1 


1424 ] 


1 0aA03 




AND 


M10000 


28 00591 ) 


1425 I 


I 0*002 




JE0 


ADD 


29 00592 I 


426 | 


I 0091A 




SB A 


RTEMl 


30 00593 1 


1427 1 


t 08801 




JU 


ADD1 


31 0059(1 1 


1428 j 


1 OOUA 


ADD 


ADA 


RTEMl 


32 00595 1 


42*> 


1 OOllC 


ADD1 


ADA 


RTEM3 


33 00596 j 


1430 j 


1 0r807 




n 


UTLRET 


3a 








ENTRY 


PATAN 


35 00597 1 


1431 •! 




patan 


EQU 


* 


36 00597 1 


1431 1 


OtllB 




STAB 


RTEM2 


37 00598 j 


1432 1 


I 0?A40 




CLB 




38 00599 j 


1431 j 


I 0?11A 




STB 


RTEMl 


39 0059A 


1434 1 


I 07801 




JLT 


NEGN 


40 0059B 


1435 1 


I 0*807 




M 


POSN 


41 0059C 


L436 .1 




NEGN 


EQU 


* 


42 0059C 


1436 1 


, 029C 




CPA 




43 0059D 


1437 


I O78O1 




JLT 


NEGNB 


44 0059E 1 


1438 1 


1 011801 




JU 


NEGNOK 


45 0059F 


1439 1 


L 0*204 


NEGNB 


LDA 


H3PFFF 


46 005Ao 


1440 ] 


I 0*91C 


NEGNOK 


STA 


RTEM2+1 


47 005A1 1 


1441 1 


1 0(i207 




LDA 


H70000 


48 005A2 


1442 1 


X 0191A 




STA 


RTEMl 


49 005A3 


(443 •] 




POSN 


EOU 


* 


50 005A3 


1443 


\ O/jllB 




LDA 


RTEM2 



SOURCE 
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KEY 



version a.to 

DIAGNOSTICS LINF ADPES 

51 005A4 

52 005A5 

53 005A6 

54 005A6 

55 005A7 

56 005A8 

57 005A8 

58 OO5A9 

59 005AA 

60 005AB 

61 005AC 

62 005AD 

63 005AE 

64 005AF 

65 00580 

66 005B0 

67 005RI 

68 005B2 

69 00583 

70 005B4 

71 005B5 

72 005B6 

73 005B7 
7a 005B8 

75 005B9 

76 005BA 

77 005BB 

78 005BC 

79 005BC 

80 005BO 

81 005BE 

82 005BF 

83 OO5CO 
8a 005C1 
85 



DECK NAME»*UTltIT* 



daores lc Program 








jaaa 


I 07803 




JIT 


NEGD 


1445 


I OflSOA 




JU 


POSD 


1446 • ] 




DEQN 


EQU 


* 


1446 


I 04202 




IDA 


HOrFFF 


1447 


i 0*818 




JU 


RESULT 


ia«» -i 




NEGO 


EQU 


* 


1448 


I 0?9Co 




CPA 




1449 


I O78O1 




JLT 


NEGDB 


1450 


I 08801 




JU 


NEGDOK 


1451 


I 04204 


NEGDB 


LDA 


H3FFFF 


ia52 


I 0^918 


NEGDOK 


8TA 


RTEM2 


1*53 1 


1 04205 




IDA 


H30000 


1454 1 


I 0«91A 




SBA 


RTEM1 


1455 


0^91A 




8TA 


RTEM1 


1456 • 




POSD 


EQU 


* 


1456 1 


, 04 HC 




LDA 


RTEM2+1 


1457 j 


I 009iB 




8BA 


PTEM2 


1458 1 


I O78O9 




JLT 


OGTN 


1459 | 


I 0*7F2 




JEO 


DEQN 


1460 j 


I 0491B 




LDAB 


PTEM2 


1461 


\ 0?880 




EAR 




1462 I 


I OlttB 




STAB 


RTEM2 


1463 1 


i 04UA 




LDA 


RTEM1 


1464 ] 


I 0?B82 




SLC 


2 


1465 1 


I 00206 




ADA 


H40000 


1466 1 


t 0?BC2 




spc 


2 


1467 1 


0|9lA 




STA 


RTEM1 


1468 •) 




DGTN 


EQU 


* 


1468 1 


0411C 




LDA 


RTEM2+1 


1469 ] 


L 0pA40 




CLB 




J470 1 


I 0191B 




DIV 


RTEM2 


1471 1 


I 0?B42 




8RAD 


2 


1472 1 


i OpllA 


RESULT 


OR 


RTEM1 


1473 j 


[ 0C807 




JI 

END 


UTLRET 



SOURCE 



C-3 



F4202-! 2/75 



-*1 



o 

to 



O 



X^E* 1 DECK NAMEb*UTILIT* 
RfLATtVE ADDRESS 

(0« <*FT VAIUE) VARIABLE NAMp 
HEX DEC LC 



005*4 


1428 l 


I ADD 


005^5 


1429 ] 


I A001 


0057A 


1402 i 


I A TAN 


005*6 


1446 1 


I OEQN 


005*C 


1468 ■• l 


I DGTN 


00202 


514 


H0FFFF 


00203 


515 


H10000 


00204 


516 


H^FFFF 


00205 


517 


H30000 


00206 


518 


H40000 


00207 


519 


H7O00O 


005*8 


1451 1 


I NEGRB 


005*C 


1452 1 


I NEGDOK 


005*8 


1448 1 


1 NEGO 


005*F 


14 39 1 


I NEGNB 


005*0 


1440 1 


I NEGNOK 


005U 


1436 ] 


1 NEGN 


005V 


1431 1 


I PATAN 


005*0 


1456 j 


I POSD 


005*3 


1443 ] 


I P08N 


005C0 


1472 1 


I RESULT 


0011 A 


282 


RTEMl 


001 IB 


283 


RTFM2 


oouc 


284 


RTEM3 


00212 


530 


UCT11 


00208 


520 


UCT1 


0020A 


522 


UCT3 


0020C 


524 


UCT5 


0020E 


526 


UCT7 


00210 


528 


UCT9 


00007 


7 


UTLRET 



SKC 3000 CROSS REFERENCE DICTIONARY 



LINE NUMBERS OF UPRENCFS 
DEFINED REFERENCES 



31 

32 

4 

53 

78 

BLKOTA 

BLKDTA 

BLKDT* 
BLKDTA 

BLKOTA 
BLKDTA 
60 
61 
56 
45 
46 
41 
35 
65 
49 
83 
BLKOTA 

BLKOTA 

BLKOTA 
BLKDTA 
BLKDTA 
BLKDTA 
BLKOTA 
BLKDTA 
BLKOTA 
BLKDTA 



28 
30 

3 
69 
68 
54 
27 

8 
62 
75 
25 
58 
59 
51 
43 
44 
39 
34 
52 
40 
55 

9 
83 
11 
72 

5 
12 
21 
19 
17 
15 
13 
33 



-< 
ro 

o 
> 

O 



O 

00 



3 C 



45 
47 



60 



> 
3D 



g 

< 



m 

z 
<n 
m 

30 

o 
o 



10 

14 
79 
24 



22 
!6 

at 

26 



23 
!8 
32 



29 

20 



31 
36 



38 
46 



48 
50 



63 
61 



64 
66 



73 
67 



77 

70 



O > 

z z 

-< 



84 
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TABLE D - 1 



SKC3120 INSTRUCTION SET 



MNEM. 


OPERATION NAME 


ABSF 


ABSOLUTE OF A 


ADA 


FIXED ADD MEMORY TO A 


ADAB 


FIXED ADD MEMORY TO AB 


ADAX 


FIXED ADD MEMORY TO A INDEXED 


ADC 


FIXED ADD CARRY TO A 


ADF 


FLOAT ADD MEMORY TO AB 


ADFI 


FLOAT ADD MEMORY TO AB, INDIR 


ADM EM 


FIXED ADD A TO MEMORY 


ADX 


FIXED ADD A TO ACTIVE INDEX 


AND 


LOGICAL AND 


ANDM 


LOGICAL AND TO MEMORY, BASED 


CFX 


CONVERT FLOAT TO FIXED IN AB 


CLB 


CLEAR B 


CMA 


ONE'S COMPLEMENT A 


CMS 


SKIP ON A .LT. MEMORY 


CPA 


TWO'S COMPLEMENT A 


CPAB 


TWO'S COMPLEMENT AB 


CXF 


CONVERT FIXED TO FLOAT IN AB 


DIAX 


INPUT DATA INTO A INDEXED 


DIV 


FIXED DIVIDE A BY MEMORY 


DOAX 


OUTPUT DATA OUT OF A INDEXED 


DPI 


DISABLE PROGRAM INTERRUPTS 


DSZ 


DECREMENT MEMORY, SKIP IF 


DXS 


DECREMENT ACT INDEX, SKIP IF 


EAB 


EXCHANGE A AND B 


EPI 


ENABLE PROGRAM INTERRUPT 


EXR 


EXCH ACTIVE AND INACTIVE INDEX 


FN EG 


FLOAT NEGATE AB 


HLT 


HALT 


IN CMS 


FIXED INCREMENT MEMORY 




AND SKIP IF 


JEQ 


JUMP IF (A) .EQ. 


JGE 


JUMP IF (A) .GE. 


JGT 


JUMP IF (A) .GT. 


Jl 


JUMP INDIRECT 


JLE 


JUMP IF (A) . LE. 


JLT 


JUMP IF (A) .LT. 


JNE 


JUMP IF (A) .NE. 


JS 


JUMP TO SUBROUTINE 


JU 


JUMP UNCONDITIONAL 


LDA 


LOAD A FROM MEMORY 


LDAB 


LOAD AB FROM MEMORY 



MNEM. 


OPERATION NAME 


LDABI 


LOAD AB FMOM MEMORY, INDIR 


LDABX 


LOAD AB FROM MEMORY, INDEXED 


LDAM^ 


LOAD A^ IMMEDIATE 


LDAX 


LOAD A4FROM MEMORY INDEXED 


LDR 


LOAD REGISTER FROM A 


LDX 


LOAD ACTIVE INDEX FROM MEMORY 


LDXM-"^ 


LOAD ACTIVE 1 NDEX IMMEDIATE 


MLFI 


FLOAT MPY AB BY MEMCK Y, INDIR 


MOV 


MOVE MEMORY TO MEMORY 


MUL 


FIXED MPY A BY MEMORY 


MULAB 


FIXED MPY AB BY MEMORY 


MULF 


FLOAT MPY AB BY MEMORY 


MULX 


FIXED MPY A BY MEMORY INDEXED 


OR 


LOGICAL OR 


ORM 


LOGICAL OM TO MEMORY 


SBA 


FIXED SUB MEMORY FROM A 


SBAB 


FIXED SUB MEMORY FROM AB 


SBAX 


FIXED SUB MEMORY FMOM A 1 NDEXD 


SBC 


FIXED SUB CARRY FROM A 


SBF 


FLOAT SUB MEMORY FROM AB 


SBFI 


FLOAT SUB MEMORY FROM AB, INDIR 


SDX 


VARIABLE SHIFT, INDEXED 


SKPMZ 


SKIP ON MEMORY BITS 0, BASED 


SKPM1 


SKIP ON MEMORY BITS 1, BASED 


SLC 


SHIFT A LEFT, CIRCULAR 


SLL 


SHIFT A LEFT, LOGICAL 


SLLD 


SHIFT AB LEFT, LOGICAL 


SRA 


SHIFT A RIGHT, ARITH 


SRAD 


SHIFT AB RIGHT, ARITH 


SRC 


SHIFT A RIGHT, CIRCULAR 


STA 


STCKE A IN MEMORY 


STAB 


STORE AB IN MEMORY 


STABI 


STORE AB IN MEMORY, INDIR 


STABX 


STORE AB IN MEMORY, INDEXED 


STAX 


STORE A INDEXED 


STB 


STORE B IN MEMORY 


STR 


STORE REGISTER IN A 


STX 


STORE ACTIVE INDEX IN MEMOMY 


TRP1 


TRAP 1 


TRP2 


TRAP 2 


TRP3 


TRAP 3 


TRPU 


TRAP k 
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COMMENTS AND EVALUATIONS 

Your evaluation of this document is welcomed by the Singer Company. 

Any errors, suggested corrections or general comments may be made 
and continued on the reverse side. Please include page number and 
reference paragraph and forward to: 

The Singer Company 

Aerospace and Marine Systems 

Kearfott D? vi sion 

150 Totowa Road 

Wayne/ New Jersey 07470 

Attention: Department 5760 



Name 

Company Affiliation 

Address 
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